home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 July / EnigmA AMIGA RUN 09 (1996)(G.R. Edizioni)(IT)[!][issue 1996-07 & 08][EARSAN CD VIII].iso / earcd / util3 / newdir.rdm < prev    next >
Text File  |  1996-06-17  |  10KB  |  326 lines
  1. Short:    NewDir V1.4 is a replacement of the WB Dir with many new features
  2. Author:   Mr. Bluesky / Drifters (Lionel Guillang)
  3. Uploader: Pagnotta Alexandre (Pôle Universitaire Européen Nancy-Metz, France)
  4. Type:     util/sys
  5. Name:     NewDir V1.4
  6.  
  7. ------------------DRIFTERS------------------
  8.        _______  _____________  ___  ____
  9.    ___/  /  _ \/__/ __/_  _/_\/ _ \ \  _\
  10. ==/ _   /  /__/ /  __/ / / __/ /__/_/_/  =
  11. -/ /   /  / /  /  /   / / |_  / /__\ \ --
  12. /______/_/__/__/_/HKD/_/___/_/__/\___/©96
  13.    => NewDir V1.4 Replacement For Dir <=
  14. [---------X-FILES-+33-876-740-54-----------]
  15. --[ AMIGA OS 3.x - UTILS 2 SPREAD ]---------
  16.  
  17. NewDir V1.4 docs
  18. ----------------
  19.  
  20. Written by MR.BLUESKY
  21. Copyright ©1993-95 DRIFTERS HDC Inc.
  22. All rights reserved
  23.  
  24.  ! FREELY REDISTRIBUTABLE !
  25.  
  26. This program cannot be sold, nor used for ANY commercial purpose
  27. without my personal written permission. You can find my address
  28. at the end of this text.
  29.  
  30. It's provided as is, without any warranty; use it at your own risk !
  31.  
  32. Please DO NOT compress NewDir with an 'executables auto-decompress'
  33. packer, as it may make it crash. Archivers like LhA are ok for
  34. redistribution.
  35.  
  36.  
  37.  
  38. INTRODUCTION
  39. ~~~~~~~~~~~~
  40.  
  41. NewDir is a replacement command for AmigaDos dir & list commands.
  42. It features most options of these commands plus some goodies.
  43. It's of course reentrant and so can be made resident in your system.
  44.  
  45. NewDir is MC68000 upto MC68040 compatible (tested on MC68000, MC68EC20
  46. and MC68040 based machines), but requires at least OS II (2.04).
  47.  
  48. WARNING: NewDir now makes deeper usage of stack, and shell default
  49.      stack size (4096 bytes) may not be enough in some cases
  50.      (deep volumes trees).
  51.      So, if you observe random crashes, increase size to 8KB
  52.      (use the 'stack' command in shell or modify shell startup).
  53.      
  54.  
  55.  
  56. WHAT'S NEW
  57. ~~~~~~~~~~
  58.  
  59. o 12 new possible args/options.
  60.  
  61. o pattern auto-recognition (P option removed).
  62.  
  63. o dynamic output: number of columns is now adjusted according to
  64.   shell window width. Also allows to generate custom output.
  65.  
  66. o shorter & faster code; 68020/030/040 Icaches used as much as
  67.   possible.
  68.  
  69. o bug that sometimes corrupted shell stack now fixed.
  70.  
  71.  
  72.  
  73.  
  74. NEW ARGS/OPTIONS DESCRIPTION
  75. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  76.  
  77. o OPT / keyword   : 'a' options now works (see 'SEARCH' below).
  78.  
  79. o TIMES / switch  : add entries creation times to display.
  80.  
  81. o ATTR / switch   : replaces the BITS switch.
  82.  
  83. o KEYS / switch   : add entries disk keys to display.
  84.  
  85. o SINCE / keyword : show only if later or equal than specified date/time
  86.  
  87.             e.g: nd since=2-mar-94
  88.                  nd since="2-mar-94 14:58"
  89.                  nd since="yesterday 13:15:10"
  90.  
  91.            notes: * words (like month, 'yesterday', 'today'...) must
  92.                     be entered in your own language if your system is
  93.                     localized.
  94.  
  95.                   * Month may be more than 3 chars long (depends on
  96.                     language too); try 'nd DATES' to check this out.
  97.  
  98.                   * Leading 0 in both date & time are not required.
  99.  
  100.               * Stamp must be enclosed by quotes if you specify
  101.                 both date and time.
  102.  
  103.               * Date (if specified) must be entered first.
  104.  
  105.               * Words are case insensitive.
  106.  
  107. o UPTO / keyword  : show only if earlier or equal than specified date/time
  108.  
  109.             e.g: nd upto=11:00
  110.                  nd upto=today
  111.                  nd upto="10-dec-93 12:30:35"
  112.  
  113.           notes: see SINCE notes above.
  114.  
  115. o QUICK / switch  : show only entries names without any further infos.
  116.  
  117. o BLOCK / switch  : show files sizes in blocks rather than in bytes.
  118.  
  119. o NOHEAD / switch : directory head line not displayed.
  120.  
  121. o NOSTAT / switch : directory/volume statistics not displayed.
  122.  
  123. o NOICONS / switch: hide .info files.
  124.  
  125. o NOANSI / switch : output is pure ASCII (monochrome): useful when
  126.             redirected.
  127.  
  128. o SEARCH / switch : show all subdirs contents; useful to look for a 'lost'
  129.             file.
  130.             
  131.             e.g: nd sys:lost.exe search   will search for all
  132.                                           occurences of 'lost.exe'
  133.                                           in all subdirs of sys:
  134.                  
  135.                  nd work:#?.gif search   will search for all GIF
  136.                              files in all subdirs of work:
  137.                              
  138.  
  139. o LFORMAT / keyword: allows you to produce custom directory output; useful
  140.              for script (batch) files creation.
  141.              
  142.              e.g:
  143.  
  144.         nd >ram:arf work:#?.gif LFORMAT="rename %s%s as %stemp/new_%s"
  145.              
  146.                   will produce a script file (ram:arf) which moves and
  147.                   renames all GIF files from work: root to temp/ , ie:
  148.                   
  149.                   rename work:pict1.gif as work:temp/new_pict1.gif
  150.                   rename work:pict2.gif as work:temp/new_pict2.gif
  151.                     .
  152.                     .
  153.                     .
  154.                   rename work:pict90.gif as work:temp/new_pict90.gif
  155.  
  156.                   
  157.            %s occurences interpretation:
  158.            
  159.                %s       pastes <filename>
  160.                %s%s       pastes <path><filename>
  161.                %s%s %s       pastes <path><filename> <fileaname>
  162.                %s%s %s%s  pastes <path><filename> <path><filename>
  163.                
  164.         Notes: * Names and pathes are always current directory relative.
  165.         
  166.                * Format line must be enclosed by quotes if you enter
  167.                  some space chars.
  168.                   
  169.                              
  170.  
  171. FILE PATTERN PROCESS
  172. ~~~~~~~~~~~~~~~~~~~~
  173.  
  174. As you noticed in the examples above, NewDir now auto-recognizes pattern as
  175. target dir/file.
  176.  
  177. All standard AmigaDos wildcards are supported: ?,#,|,~,[,],%,* (optional in
  178. OS II). See your AmigaDos manual for further infos about wildcards.
  179.  
  180. Note: Pattern matching is case-insensitive.
  181.  
  182.  
  183.  
  184.  
  185. OPTIONS / KEYWORDS INCOMPATIBILITIES
  186. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  187.  
  188. Some options or keywords exclude or force other ones. They may also conflict.
  189. Don't panic though, worst conflict CANNOT lead to a crash !
  190.  
  191. Here are the main side effects that you should know about:
  192.  
  193. o INTER: disables QUICK, KEYS, NOANSI options.
  194.      forces DATES, ATTR options.
  195.      unpredictable output if used with LFORMAT.
  196.  
  197. o LFORMAT:
  198.      disables KEYS, DATES, ATTR options.
  199.      forces QUICK, NOANSI, NOHEAD, NOSTATS.
  200.      unpredictable output if used with INTER.
  201.  
  202. o SEARCH:
  203.      disables directory filtering.
  204.  
  205. o HELP:  overrides all other args.
  206.  
  207. o ABOUT: overrides all other args.
  208.  
  209. o SINCE: unpredictable output if used with UPTO in paradoxal way.
  210.  
  211. o UPTO:  unpredictable output if used with SINCE in paradoxal way.
  212.  
  213.  
  214.  
  215. OLD ARGS/OPTIONS
  216. ~~~~~~~~~~~~~~~~
  217.  
  218. The following args/options are unchanged since version 1.3:
  219.  
  220. o OPT (a|d|i)    : only here for Commodore's dir compatibility.
  221.           you should better use OS II new switches instead.
  222.  
  223.           a = SEARCH
  224.           d = DIRS
  225.           i = INTER
  226.           
  227.           see corresponding switches explanations for further infos.
  228.  
  229.  
  230. o DIRS        : shows dirs entries only.
  231.  
  232. o FILES        : shows files entries only.
  233.  
  234. o LINKS        : show links (file and dirs, both hard and soft) only.
  235.  
  236. o DATES        : add entries creation dates to display.
  237.  
  238. o NOSORT    : don't alpha sort entries.
  239.  
  240. o INTER        : start interactive mode; interactive mode output stops after
  241.           each entry and allows you to enter a command.
  242.  
  243.           possible commands are:
  244.           
  245.           *        D = delete entry
  246.           *        T = dump entry contents (ASCII)
  247.           *        H = dump entry contents (Hexadecimal)
  248.           *        C = enter any other AmigaDos command
  249.           *        S = skip entry
  250.           *        Q = quit interactive mode (abort)
  251.           * <RETURN> = S (skip)
  252.           
  253.           
  254.           
  255. o ABOUT            : show NewDir version/credits
  256.  
  257. o HELP        : show NewDir quick help
  258.  
  259. o ?        : show NewDir args template
  260.  
  261.  
  262.  
  263. CONTACT ADDRESS
  264. ~~~~~~~~~~~~~~~
  265.  
  266. If you want to get in touch with me, write to:
  267.  
  268. Lionel GUILLANG
  269. 6, rue de la Martinique
  270. 75018 PARIS
  271. FRANCE
  272.  
  273. No answers guaranted, I'm sooo busy !
  274.  
  275.   - --  ---( CaLL OuR BoARDS! )--- > 
  276.  
  277.                      .                                                                                      
  278.    *   .              °  *  .     °    .      \|/  .   °      .      ° .   *
  279. °           °      .                .     *  (©_©)   .
  280.  .    .gæ      __/\__  *   ,.ææ_          oOO·(_)·OOo   :ØØæ.  °   áØØØØ# .
  281.      åØØØØ&    \ øø / .  ,øØØØØØ#,     ° ,ØØØØØØØØØØQ_  VØØØØ     .ØØØØØ"
  282.      åØØØØ& .  /`--'\   _ØØØØØØØØN °    [ØØØØØØØØØØØØ_   °ØØØØØ    ØØØØØF
  283.  °   ¬ØØØØØ    ¯¯\/¯¯  JØØØØØØØØØØ#  .  IØØØØØ___ØØØ'~  .  ØØØØØ_¸ØØØØØP  °.
  284.  *    ØØØØØ#_æØØQæ__  JØØØØØضØØØØØQ    ÍØØØØØØØØØØØØø__    ØØØØØØØØØØV
  285.       7ØØØØØØØØØØØØØ__ØØØØØØ__0ØØØØØ, * ÌØØØØØØØØØØØØØØØL    ØØØØØØØØ@   .
  286.     °  ØØØØØØØØØØØØØØØØØØØØØØØØØØØØØM   [ØØØØØØØØØØØØØØØØþ °  ØØØØØØ'  
  287.    .   ØØØØØØØ°"ØØØØØØØØØØ"¯¯ ¯VØØØØØ_  ØØØØØØØ'    ¬ØØØØØ   ,ØØØØØ´___|\*
  288.     *  0ØØØØØ   ØØØØØf°^°¯  .   ØØØØØ® ,ØØØØØØØø____dØØØØØ   ØØØØØF ¾¾¾¾¾\ 
  289. °      0ØØØØØ.æÆØØØØØ           `ØØØØØ&ØØØØØØØØØØØØØØØØØØ´  ØØØØØ1 ¾¾¾¾¾¾¾) 
  290.     .  0ØØØØØØØØØØØØF    °   .   0ØØØØØØØØØ@ØØØØØØØØØØÞ°   ØØØØع ¾¾¾¾¾¾¾/    
  291. .    * ¬ØØØØØØØØØØØ°   .     *   ¶ØØØØج°°~~~¨¨~¨~"¯.   *  ØØØØØ   ¯¯¯¯l/ °
  292.          °^~ "°°°¯                "¤¤°     °     *         ¤Øؤ°
  293.   _¸,.xXx.,¸_¸,.xXx.,¸_¸,.xXx.,¸_¸,.xXx.,¸_¸,.xXx.,¸_¸,.xXx.,¸_¸,.xXx.,¸TøF
  294.   ¯~°¤×xפ°~¯~°¤×xפ°~¯~°¤×xפ°~¯~°¤×xפ°~¯~°¤×xפ°~¯~°¤×xפ°~¯~°¤×xפ°~¯
  295.       STAFF: CLARY/DFT  SH0CKER/DFT  FURY/PSG/CRX  MULDER/DFT
  296.                        BABY              X-FILES
  297.                    +33-ASK-FOR-IT     +33-876-740-54
  298.                      AMIGA ONLY!       PSX SUPPORT!
  299. ------------------------------------------------------------------------
  300.  
  301.   This Is Our Complete Memberslist In April 1996
  302.  
  303.   CLArY................Coder/Sysop/Graphician/Raytracer
  304.   Sh0CKER..............Sysop/Guides/System/Trader
  305.   MuLDER...............Sysop/Trader/Raytracer
  306.   T0f..................Graphician/Ascii/Design
  307.   L'AnOME..............Trader/System
  308.   GoLDEN HeLL..........Graphician/Raytracer/Trader
  309.   SeB..................Graphician
  310.   Io...................Graphician/Swapper
  311.   242..................Coder/Raytracer
  312.   Mr.BlUESKY...........Coder
  313.  
  314.   Other Friends Who Are Supporting Us (The List Is Not Complete Sorry!)
  315.  
  316.   FuRY/PSG^CRuX........Sysop/Trader
  317.   SmT/ArtWork..........Musician
  318.   FaLCON/PsK^HoNOO.....Musician
  319.   LOrDs/ABsOLUTE.......Sysop/Trader
  320.   LoWLIFE/AXiS.........Graphician/Trader
  321.   ZiNKO/RYL/PB.........Sysop/Trader
  322.  
  323.     We Are Always Looking For More Active Euro Sceners Who Like
  324.   To Join Our Fun Crew. You Think You've Got What It Takes & Want 
  325.   To Join DRIFTERS, Then Contact MuLDER On His Board X-FILES.
  326.